Skip to content

nix-tools: link to repository from Hackage (homepage, bug-reports, source-repository) - #2545

Open
hamishmack wants to merge 4 commits into
masterfrom
hkm/issue-1680-nix-tools-cabal-metadata
Open

nix-tools: link to repository from Hackage (homepage, bug-reports, source-repository)#2545
hamishmack wants to merge 4 commits into
masterfrom
hkm/issue-1680-nix-tools-cabal-metadata

Conversation

@hamishmack

Copy link
Copy Markdown
Collaborator

Summary

The published nix-tools package's Hackage page has no link back to its source repository, which the reporter of #1680 needed when cataloguing Haskell-Nix projects. nix-tools/nix-tools/nix-tools.cabal carried only name/synopsis/license/author/maintainer.

This adds the standard linking metadata:

  • homepage: https://github.com/input-output-hk/haskell.nix
  • bug-reports: https://github.com/input-output-hk/haskell.nix/issues
  • a source-repository head stanza (git, the repo URL, subdir: nix-tools/nix-tools)

Testing

cabal check in nix-tools/nix-tools/ parses the manifest cleanly with the new fields — the only diagnostics are pre-existing PVP missing-upper-bound warnings/errors (e.g. base) that are unrelated to this change and present on master.

Notes

  • The metadata only appears on Hackage once the next nix-tools release is cut (nix-tools is consumed by haskell.nix as a prebuilt static release binary), so this has no effect on haskell.nix builds themselves.
  • Please, upload docs to Hackage, and link to the official upstream #1680 also asked that haddock docs be uploaded with releases. That is a release-process change (cabal upload --documentation, or relying on Hackage's doc builder), not a source change, and there is no single obvious release checklist in-repo to amend — so it's left as a release-process follow-up (see the static-nix-tools release step tracked in error in flake. #2506) rather than forced into this diff.

Closes #1680.

Add homepage, bug-reports and a source-repository head stanza so the
Hackage page for the published nix-tools package links back to this
repository (see #1680). The metadata reaches Hackage on the next
nix-tools release.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds missing Cabal package metadata so the published nix-tools Hackage page links back to the upstream haskell.nix repository, addressing the discoverability request in #1680.

Changes:

  • Add homepage and bug-reports URLs pointing to the GitHub repo and issue tracker.
  • Add a source-repository head stanza (git + repo URL + subdir) so Hackage can display the upstream source location.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Please, upload docs to Hackage, and link to the official upstream

2 participants